Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add sustainability modules to mapping documentation #422

Merged
merged 22 commits into from
Nov 6, 2023

Conversation

duncandewhurst
Copy link
Contributor

@duncandewhurst duncandewhurst commented Nov 2, 2023

Related issues

Description

The mapping is stored in sustainability.yaml and there are two new manage.py commands:

  • update-sustainability-docs generates the Markdown content in docs/cost/ids/sustainability.md using sustainability.yaml.
  • lint formats and validates the data in sustainability.yaml and reports missing data

Presently, lint reports many additional fields and some missing data. This is expected because the schema is not yet updated and because the mapping for some elements is still under discussion.

However, I suggest that we merge this PR as-is and then, as part of each schema or codelist change PR, we can update the relevant mappings and examples in sustainability.yaml.

Before releasing, OC4IDS 0.9.4 we can do a final copy edit of the mappings and examples for consistency and check that lint reports no additional fields or missing data. I'll create a separate issue about that.

The spell-check is failing on the "TNE" unit code referenced in the mapping. @jpmckinney is there somewhere that needs to be added to a dictionary?

Merge checklist

If there are changes to project-schema.json or project-package-schema.json:

  • Update the examples:
    • docs/examples/example.json
    • docs/examples/blank.json
  • Run ./manage.py pre-commit to update docs/_static/i8n.csv

If you added a new definition to the schema, run ./manage.py pre-commit.

If you added a new codelist:

  • Add an entry to docs/reference/codelists.md

@duncandewhurst duncandewhurst requested review from odscjen and jpmckinney and removed request for odscjen November 2, 2023 04:12
@duncandewhurst duncandewhurst marked this pull request as ready for review November 2, 2023 04:13
@jpmckinney
Copy link
Member

For spellcheck, change -L zar to -L tne,zar in spellcheck.yml.

Copy link
Member

@jpmckinney jpmckinney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like a straight split of the content (i.e. without additional changes), plus the addition of the sustainability content (which will continue to change).

If that's the case, then my only comment is with heading levels having changed.

docs/cost/ids/core.md Outdated Show resolved Hide resolved
@duncandewhurst
Copy link
Contributor Author

Looks like a straight split of the content (i.e. without additional changes), plus the addition of the sustainability content (which will continue to change).

Yep, that's correct.

docs/cost/ids/core.md Outdated Show resolved Hide resolved
docs/cost/ocds.md Outdated Show resolved Hide resolved
@duncandewhurst
Copy link
Contributor Author

I realised that docs/cost/ids/index.md was missing any content so I've added a description of its sub-pages. At the same time, I added introductory sentences to other pages under docs/cost and updated page titles to use sentence case.

Copy link
Member

@jpmckinney jpmckinney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few small changes, then good to merge :)

docs/cost/ids/core.md Outdated Show resolved Hide resolved
docs/cost/ids/core.md Outdated Show resolved Hide resolved

This page documents a mapping from the 'core' CoST IDS elements to OC4IDS fields and codes. The organization of the mapping tables reflects the structure of the CoST IDS.

The CoST IDS sets out a number of disclosure requirements under the heading of 'information for disclosure upon request', also known as 'reactive disclosure'. You can disclose these elements proactively using OC4IDS. Separate tables are provided for project-level and process-level reactive disclosures.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this paragraph also be present in ocds.md?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes! Added in a198afb

docs/cost/ocds.md Outdated Show resolved Hide resolved
docs/cost/ids/index.md Outdated Show resolved Hide resolved
@duncandewhurst duncandewhurst merged commit af204bc into 0.9-dev Nov 6, 2023
10 checks passed
@duncandewhurst duncandewhurst deleted the oc4ids-review-docs branch November 6, 2023 22:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add sustainability modules to mapping documentation
2 participants